home *** CD-ROM | disk | FTP | other *** search
/ PC Media 4 / PC MEDIA CD04.iso / share / os2 / repeat / read.me < prev    next >
Encoding:
Text File  |  1993-09-29  |  4.2 KB  |  103 lines
  1.  
  2. This archive contains the PMREXX script "Repeat.CMD".
  3.  
  4. PURPOSE
  5. =======
  6. The function of Repeat.CMD is to play a given multimedia file
  7. a number of times in a row, or to keep playing it continuously.
  8. For example, you can use it with OS/2's built-in Software Motion Video
  9. to create a continuously running video clip on your screen.
  10.  
  11. DIRECTIONS FOR USE
  12. ==================
  13. Repeat.CMD must be run as a PMREXX script. That is, you cannot run it
  14. directly from the command line; you must start PMREXX, passing
  15. Repeat.CMD as its first argument. For example:
  16.  
  17.    [E:\MMOS2\MOVIES] start pmrexx repeat file=MACAW.AVI
  18.  
  19. This will start playing the video clip MACAW.AVI. To have it play
  20. a certain number of times and then stop, use:
  21.  
  22.    [E:\MMOS2\MOVIES] start pmrexx repeat file=MACAW.AVI count=3
  23.  
  24. To stop the play, close the PMREXX session (NOTE: not just the
  25. device!) from the Window List. For example, if you gave the
  26. command in the first example above, you would have two entries
  27. in the Window List: "The PM/REXX Interface" and "IBM Ultimotion(TM)".
  28. To stop the video clip, select "The PM/REXX Interface" from the
  29. Window List, click the right mouse button to get the pop-up menu,
  30. and choose "Close".
  31.  
  32. The best way to use Repeat.CMD is to create a Program Reference object.
  33. If you specify FILE='%*' in the Parameters field, you can
  34. play any multimedia file by simply dropping it on the Program Reference.
  35. This archive includes a REXX script, INSTALL.CMD, that installs two such
  36. Program References on your Desktop. (You can drag these to a more
  37. appropriate location; e.g. the Movies folder.)
  38.  
  39. ARGUMENTS TO REPEAT.CMD
  40. =======================
  41. Repeat.CMD can take a number of "keyword=value" pairs as arguments.
  42. The keyword must be one of: FILE, DEV, FROM, TO, TIMEFMT, or COUNT.
  43. Each keyword may occur at most once on a single command line.
  44. The keyword is not case sensitive. There may not be any space
  45. between the keyword and the "=", nor between the "=" and the value.
  46.  
  47. The meaning of the keywords is:
  48.  
  49. FILE=filename           Play the given multimedia file. If FILE
  50.                         is given, and DEV is not given, the file
  51.                         is examined to decide which device it should
  52.                         be played on.
  53.                         If the filename contains spaces, it must
  54.                         be enclosed in single or double quotes,
  55.                         as in: FILE='file name'.
  56.  
  57. DEV=device              Play the given device.
  58.  
  59.                         Either the FILE or the DEV argument (or both)
  60.                         must be specified, the other arguments are
  61.                         optional.
  62.  
  63. TIMEFMT=format          Specify the time format. Exact values depend
  64.                         on the device.
  65.  
  66. FROM=start              Specify the starting position. Exact values
  67.                         depend on the device, and presumably on the
  68.                         TIMEFMT. On the Software Motion Video device,
  69.                         if TIMEFMT is not given, the position is specified
  70.                         simply as a frame number (zero being the first frame).
  71.  
  72. TO=end                  Specify the ending position. See FROM.
  73.  
  74. COUNT=count             Specify the number of times the play command
  75.                         is to be performed. If COUNT is omitted, the
  76.                         playing repeats forever (until you stop it
  77.                         from the Window List).
  78.  
  79. ACKNOWLEDGMENTS
  80. ===============
  81. This script was created by modifying the example REXX Script, PLAY.CMD,
  82. included in the MMOS2 directory of the Multimedia PM package.
  83.  
  84. CAVEATS
  85. =======
  86. Repeat.CMD was primarily intended to play Software Motion Video clips.
  87. It has not been tested with other types of multimedia files.
  88. It might need slight modifications because, if you do not specify
  89. the FROM argument, it inserts a "from 1" into the play command;
  90. depending on the device and the TIMEFMT, that might not be
  91. appropriate.
  92.  
  93. The script has been tested with HPFS file names for the FILE argument.
  94. If you need to use values with spaces in them for the other arguments,
  95. slight modifications to the MCI commands might again be necessary.
  96. See the REXX code.
  97.  
  98. AUTHOR
  99. ======
  100. Ari Schot, 29 September 1993
  101. Internet: delft@fwi.uva.nl
  102.  
  103.